home *** CD-ROM | disk | FTP | other *** search
/ The CICA Windows Explosion! / The CICA Windows Explosion! - Disc 2.iso / programr / winexit.zip / README.1ST < prev    next >
Text File  |  1993-07-19  |  5KB  |  120 lines
  1.                            WinExit Archive
  2.  
  3.  
  4.  
  5. List of files:
  6. --------------
  7.  
  8. readme. 1st    -    this file.
  9. winexit.exe    -    ready to run binary, compiled with Borland
  10.                     C++ v3.1 for small model, Windows 3.1, VGA,
  11.                     and 386 (or higher) processor. If you wish to
  12.                     run it on a 286, you'll have to recompile it.
  13.                     Note: the program *will not* run under v3.0 of
  14.                     Windows.
  15. winexit.c      -    C source
  16. winexit.h      -    header file
  17. winexit.def    -    module definition file
  18. winexit.rc     -    resource file
  19. winexit.ver    -    version stamp
  20. winexit1.bmp   -    bitmap (used in About Box)
  21. winexit2.bmp   -    bitmap (About pushbutton - unpressed, unfocused)
  22. winexit3.bmp   -    bitmap (About pushbutton - pressed, focused)
  23. winexit4.bmp   -    bitmap (About pushbutton - unpressed, focused)
  24. winexit1.ico   -    icon
  25. winexit2.ico   -    icon
  26. winexit.prj    -    project file
  27. makefile       -    makefile for BC++ v3.1
  28.  
  29.  
  30.  
  31. Usage:
  32. ------
  33.  
  34. This program provides an easy way to get out of Windows. It can be run
  35. either from the Program Manager or it can be started and minimized so
  36. that its icon shows up in the icon area. It can be placed in a
  37. convenient group in the Program Manager or it can be placed in the
  38. StartUp group so that it shows up in the main icon area. If it is put
  39. in the StartUp group it should probably be run minimized.
  40.  
  41.  
  42. Description:
  43. ------------
  44.  
  45. Although there is a number of freely available Windows programs (with
  46. source code) on the Net, judging from the recent activity on the
  47. comp.os.ms-windos.programmer.misc, there still appears to be a slight
  48. confusion about how does one write Windows programs which have modeless
  49. dialog as their main window. Petzold's HexCalc is an example of such a
  50. program.
  51.  
  52. This program was written as an exercise in Windows programming. However,
  53. please do *NOT* judge my programming abilities on acount of that program
  54. alone (I DO need an odd programming job every now and then to survive
  55. :-).
  56.  
  57. As I wanted to use Borland Custom Control Library for the writing of the
  58. program, the (lack of) documentation about how to do it didn't make it
  59. any easier.
  60.  
  61. So, here is an example of a program which uses a modeless dialog,
  62. designed with Resource Workshop using BorDlg class for dialog windows,
  63. as the application's main window. It closely follows Petzold's HexCalc,
  64. as it uses a WndProc rather than DlgProc for processing messages from
  65. controls. It also uses a number of specific BWCC features, such as
  66. coupling of bitmaps to various controls. Look for custom About button,
  67. and bitmap in the About box. The program accepts a debug switch ("-d" or
  68. "/d"), which just throws out a BWCCMessageBox, instead of exiting
  69. windows. it also checks for other instances of itself, and if it finds
  70. one (either iconized, or full window) it brings it up to the top of the
  71. window stack. The program also modifies the system menu adding two
  72. options: QuickExit, which skips the last "Are you sure?" message box;
  73. and AlawaysOnTop, which keeps the window/icon always as the topmost
  74. window. When minimized, the program adds third option to the system menu
  75. - Exit Windows straight from the icon's menu - depending on the current
  76. radiobuttons setting. The program saves the state of those tri options
  77. into a private .INI file (WinExit.Ini), and checks these options on the
  78. startup. The program also does a limited keyboard processing - space &
  79. enter are substitutes for OK, escape for cancel, and arrow keys move
  80. radio buttons.
  81.  
  82.  
  83. Legal stuff:
  84. ------------
  85.  
  86. General permission is hereby granted to copy this program freely
  87. provided no charge is made for its distribution and provided that
  88. the copyright notice remains in place.
  89.  
  90. However:
  91. --------
  92.  
  93. If you do get an urge to make a donation (cash - for instance,
  94. although I also collect checks, source code, etc :-) to a poor
  95. postgrad student, please feel free to do so.
  96.  
  97.  
  98. Acknowledgements:
  99. -----------------
  100. Thanks to Bruce C. Wright and his EXIT utility which served
  101. as a template for this exercise in Windows programming.
  102.  
  103.  
  104.  
  105. Contacts:
  106. --------
  107.  
  108. E-mail:   nino@medphys.ucl.ac.uk
  109.  
  110. S-mail:   Nino Margetic
  111.           Dept. of Medical Physics
  112.           University College London
  113.           11-20 Capper St.
  114.           London WC1E 6AJ
  115.           U.K.
  116.           +44 (0)71-738 1938 (phone)
  117.  
  118. Copyright (c) 1993.  Nino Margetic.  All rights reserved.
  119.  
  120.